.TH std::deque::emplace_front 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::deque::emplace_front \- std::deque::emplace_front

.SH Synopsis
   template< class... Args >                   \fI(since C++11)\fP
   void emplace_front( Args&&... args );       \fI(until C++17)\fP
   template< class... Args >                   \fI(since C++17)\fP
   reference emplace_front( Args&&... args );

   Inserts a new element to the beginning of the container. The element is constructed
   through std::allocator_traits::construct, which typically uses placement-new to
   construct the element in-place at the location provided by the container. The
   arguments args... are forwarded to the constructor as std::forward<Args>(args)....

   All iterators (including the end() iterator) are invalidated. No references are
   invalidated.

.SH Parameters

   args         -         arguments to forward to the constructor of the element
.SH Type requirements
   -
   T (the container's element type) must meet the requirements of EmplaceConstructible.

.SH Return value

   \fI(none)\fP                               \fI(until C++17)\fP
   A reference to the inserted element. \fI(since C++17)\fP

.SH Complexity

   Constant.

.SH Exceptions

   If an exception is thrown for any reason, this function has no effect (strong
   exception safety guarantee).

.SH See also

   push_front inserts an element to the beginning
              \fI(public member function)\fP
